home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 1995 #5 & #6 / Amiga Plus CD - 1995 - No. 5 and 6.iso / pd / netz / amyboard / xboard-3.3.pl0 / faq < prev    next >
Internet Message Format  |  1995-08-12  |  36KB
  1. From: mann@pa.dec.com (Tim Mann)
  2. Newsgroups: gnu.chess,rec.games.chess.computer,rec.answers,news.answers
  3. Subject: FAQ -- GNU Chess and XBoard Frequently Asked Questions
  4. Followup-To: gnu.chess
  5. Summary: This posting contains a list of frequently asked questions
  6.   (with answers) about the chess-playing program GNU Chess, the X 
  7.   chess interface XBoard, and related topics often discussed on the
  8.   gnu.chess newsgroup.
  9. Reply-To: bug-gnu-chess@prep.ai.mit.edu
  10. Approved: news-answers-request@MIT.EDU
  11.  
  12. Archive-name: games/chess/gnu-faq
  13. Version: $Id: FAQ,v 1.28 1995/08/07 22:03:20 mann Exp $
  14. Posting-frequency: monthly
  15.  
  16. [1] What are the gnu.chess newsgroup and info-gnu-chess mailing list for?  How
  17.   do I subscribe or unsubscribe?
  18. [2] What is GNU Chess?
  19. [3] What is GNU Chess's rating?
  20. [4] What is XBoard?
  21. [5] Can I use XBoard to play a game of chess with another human?
  22. [6] What is XChess?
  23. [7] What is WinBoard?  Will WinBoard run on Windows 3.1?
  24. [8] What is cmail?
  25. [9] What is Winsock Chess?
  26. [10] Where can I get chess software?
  27. [11] What are the current version numbers for GNU Chess and XBoard?
  28. [12] Who is working on this project?  How do I report bugs, offer help, etc.?
  29. [13] Does GNU Chess run on a PC under DOS (or Windows)?
  30. [14] Does GNU Chess run on an Amiga?  What is AmyBoard? 
  31. [15] Does GNU Chess run on a Macintosh?
  32. [16] How do I build GNU Chess?  Do I have to have gcc?
  33. [17] How do I build XBoard?  Do I have to have gcc?
  34. [18] When I try to use GNU Chess with XBoard, it says "Error: first chess
  35.   program (gnuchessx) exited unexpectedly".
  36. [19] Sometimes GNU Chess plays an extra, bogus move after the game is over.
  37. [20] XBoard sometimes hangs when I'm using it to play against GNU Chess on a
  38.   position that I've modified with Edit Position.
  39. [21] GNU Chess often uses a little too much time and lets its flag fall
  40.   near the end of a time control period.
  41. [22] When I use GNU Chess with XBoard, it seems to freeze on me after
  42.   it gets out of its opening book.
  43. [23] When I use GNU Chess with XBoard, it sometimes tells me that moves
  44.   are illegal when they aren't.
  45. [24] GNU Chess crashes when I try to compile and run it on the DEC Alpha.
  46. [25] I get an error message about FIONREAD when trying to run (or build parts
  47.   of) gnuchess.
  48. [26] I can't build XBoard because xmkmf and imake are not present on my
  49.   system. 
  50. [27] I can't build XBoard because the "#include <X11/Xaw/...>" files are not
  51.   found.  (Often a problem for HP-UX users.)
  52. [28] When trying to build XBoard, I get error messages about undefined symbols.
  53. [29] How do I use XBoard as an external viewer for PGN files with NCSA Mosaic
  54.   or Netscape?
  55. [30] Does GNU Chess run on VMS?
  56. [31] Does XBoard run on VMS?
  57. [32] When I try to build GNU Chess, I get a message that "setlinebuf" is
  58. undefined.
  59.  
  60. -----
  61. [1] What are the gnu.chess newsgroup and info-gnu-chess mailing list for?  How
  62.   do I subscribe or unsubscribe?
  63.  
  64. The gnu.chess newsgroup is for the discussion of GNU Chess, XBoard, and other
  65. related software.  The gnu.chess newsgroup is gatewayed bidirectionally with
  66. the mailing list info-gnu-chess@prep.ai.mit.edu.  If you want to be added to
  67. or deleted from this list, mail to info-gnu-chess-request@prep.ai.mit.edu, not
  68. to the list (or newsgroup) itself.
  69.  
  70. gnu.chess is not for general chess or computer chess discussion.  You won't be
  71. flamed if you post such messages here, but you will find more information if
  72. you use rec.games.chess.  There is a rec.games.chess FAQ file with a great
  73. deal of general chess information; see topic [10] below.
  74.  
  75. PLEASE DO NOT try to start or play chess games by posting messages to
  76. gnu.chess.  Instead, read the rec.games.chess FAQ to learn about the IECG, the
  77. IECC, and other groups that you can join to find opponents, and send one or
  78. more of them email to join.
  79.  
  80. -----
  81. [2] What is GNU Chess?
  82.  
  83. GNU Chess is a chess-playing program developed as part of the GNU project of
  84. the Free Software Foundation (FSF).
  85.  
  86. GNU Chess is a communal chess program.  Contributors donate their time and
  87. effort in order to make it a stronger, better, sleeker program.  Contributions
  88. take many forms: interfaces to high-resolution displays, opening book
  89. treatises, speedups of the underlying algorithms, additions of extra
  90. heuristics.  These contributions are then distributed to the large user-base
  91. so that all may enjoy the fruits of our labor.
  92.  
  93. GNU Chess is intended to run under Unix or Unix-compatible systems.  It is
  94. written in C and should be portable to other systems.
  95.  
  96. Try WebChess, a World Wide Web interface to GNU Chess provided by DJ Delorie.
  97. The URL is http://www.delorie.com/game-room/chess/.
  98.  
  99. -----
  100. [3] What is GNU Chess's rating?
  101.  
  102. It would be irresponsible to answer this question with a number, without first
  103. explaining a few things about ratings.
  104.  
  105. The ratings that are commonly given for computer chess players are less
  106. meaningful than they may seem.  Most computer chess players (including GNU
  107. Chess) do not play in tournaments against humans, or do so only rarely, so
  108. they do not have official ratings from FIDE, USCF, or other chess
  109. organizations.
  110.  
  111. Some people have methods for rating chess programs approximately by giving
  112. them a set of problems to work on and seeing how they do, or by having them
  113. play tournaments against each other.  Any rating number produced by a formula
  114. like this should be taken with a grain of salt; it may be only a rough
  115. approximation to the rating the program would achieve in over-the-board
  116. tournament competition against humans.  The chess skills required for solving
  117. problems or playing against other computers are not necessarily the same as
  118. those required for play against humans.  Also, of course, tournaments among
  119. computers can rate the computers only relative to one another, not relative to
  120. humans.  Some of the computers need to be rated by other means to give the
  121. ratings a basis to start from.
  122.  
  123. Compared with human players, computer players are strong tactically but weak
  124. strategically, and are much better at blitz chess than at slow chess.  These
  125. differences make it more difficult to assign a meaningful rating too.
  126.  
  127. Several computers do play regularly on the Internet chess servers and have
  128. achieved ratings there.  These ratings have the advantage of being based on
  129. many games.  On the other hand, ICS ratings are only roughly comparable to
  130. USCF or FIDE ratings.  Many players have ICS ratings that are hundreds of
  131. points higher or lower than their USCF or FIDE ratings.
  132.  
  133. Finally, unlike dedicated chess machines, or PC chess programs that run on
  134. only a few different models of Intel processors, GNU Chess runs on many
  135. different kinds of CPU at many different speeds.  Thus its strength depends on
  136. how fast a machine you run it on and how much optimization your C compiler
  137. does.  Some people have formulas for estimating how a computer player's rating
  138. varies on faster or slower machines---see the rec.games.chess FAQ for more
  139. information---but these need to be taken with a grain of salt too.
  140.  
  141. All that said, here are some numbers.
  142.  
  143. - On the Internet Chess Club, a copy of GNU Chess running on an SGI Onyx R4400
  144. under the handle MaxII has achieved a blitz rating of over 2500 and a standard
  145. rating of over 2300.
  146.  
  147. - Wolfgang Gabriel ran the Bednorz-Toennissen Test BT2630 with GNU Chess 4.0
  148. pl74 on a 60 MHz Pentium with 16 MB of RAM.  The test gave an estimated rating
  149. of 2213.  He also ran Fritz-2 on the same hardware and got an estimated rating
  150. of 2311.
  151.  
  152. -----
  153. [4] What is XBoard?
  154.  
  155. XBoard is a graphical chessboard that can serve as a user interface for GNU
  156. Chess, for the Internet Chess Servers, or for email correspondence chess, or
  157. can be used by itself.
  158.  
  159. As an interface to GNU Chess, XBoard lets you play a game against the machine,
  160. set up arbitrary positions, force variations, or watch a game between two
  161. machines.
  162.  
  163. As an interface to the Internet Chess Servers, XBoard lets you play against
  164. other ICS users, observe games they are playing, or review games that have
  165. recently finished.  You don't need GNU Chess for this.
  166.  
  167. To play email correspondence chess with XBoard, you use it with the cmail
  168. program.  See topic [8] below.
  169.  
  170. You can also use XBoard as a chessboard to play through games.  It will read
  171. and write game files and allow you to play through variations manually.  You
  172. can use it to browse games off the net, or to review GNU Chess, ICS, and email
  173. correspondence games you have saved.  It saves games in PGN (portable game
  174. notation), and can read almost any game in algebraic notation.  These features
  175. are available at all times, even if you do not have access to GNU Chess or an
  176. ICS.
  177.  
  178. XBoard runs under Unix or Unix-compatible systems.  It requires the X Window
  179. System, version X11R4 or later.  There are also ports of XBoard to Microsoft
  180. Win32 (that is, Windows NT or Windows 95) and to the Amiga.  See topics [7]
  181. and [14] respectively.
  182.  
  183. -----
  184. [5] Can I use XBoard to play a game of chess with another human?
  185.  
  186. The only way for two humans on different machines to play chess in real time
  187. using XBoard is to use an Internet Chess Server as an intermediary.  That is,
  188. each player runs his own copy of XBoard, both of them log into an ICS, and
  189. they play a game there.  Two copies of XBoard cannot communicate with each
  190. other directly.
  191.  
  192. Instructions on how to get started with Internet chess are included with the
  193. XBoard distribution.  The network addresses included in the XBoard
  194. distribution may not always be current.  The oldest ICS is the Internet Chess
  195. Club at chess.lm.com, which now has a fee for registered use, but still allows
  196. free unregistered use.  There are also many newer sites with no fees, using
  197. the Free Internet Chess Server implementation (FICS).  Current FICS sites
  198. include ics.onenet.net (the most active), krypton.daimi.aau.dk,
  199. dds.hacktic.nl, holly.csv.warwick.ac.uk, and chess.pitt.edu.  On all these
  200. machines, the port number to use is 5000.  Try "finger chess@ics.onenet.net"
  201. for more address information.
  202.  
  203. Note: If you don't have network connectivity to any ICS site, you can
  204. run your own server using the FICS code.  You can get a copy by anonymous ftp
  205. from the Internet Chess Library (topic [10]).  The code is changing rapidly,
  206. so send mail to chess@ics.onenet.net and/or log into the FICS server at
  207. ics.onenet.net and ask the administrators there for current information.
  208.  
  209. The cmail program included with XBoard lets you play email postal games with
  210. another human; see topic [8].
  211.  
  212. Two humans can play chess on the same machine using one copy of XBoard in
  213. Edit Game mode, but the clocks don't run in this mode, so it's of limited
  214. usefulness.
  215.  
  216. See also topic [9].
  217.  
  218. -----
  219. [6] What is XChess?
  220.  
  221. XChess is an older chessboard program that is no longer supported.  XChess was
  222. written for X version 10, and you may or may not be able to build and run it
  223. on an X11 system.
  224.  
  225. XChess has only one significant feature that is not present in XBoard: Two
  226. humans can play chess using XChess on different machines, without using the
  227. Internet Chess Server as an intermediary.  This feature is of interest only if
  228. you don't have network connectivity to the Internet Chess Server.
  229.  
  230. Note: There actually have been several different programs called "XChess" in
  231. circulation at various times.  The above describes one that was associated
  232. with GNU Chess.
  233.  
  234. -----
  235. [7] What is WinBoard?  Will WinBoard run on Windows 3.1?
  236.  
  237. WinBoard is a port of XBoard to Microsoft Windows NT and Microsoft Windows 95
  238. using the Win32 API.  It uses the same back end chess code as XBoard, but the
  239. front end graphics code is a complete rewrite.
  240.  
  241. WinBoard does *not* run on Windows 3.1 or other MS-DOS based versions of
  242. Windows.  Although you can use the program as a PGN viewer/editor under the
  243. Win32s compatibility package, the major features (interfacing to GNU Chess and
  244. to ICS) do not work.  The main problem is that MS-DOS does not have threads or
  245. real concurrent processes.  A port of WinBoard to Windows 3.1 is possible in
  246. theory, but it would be difficult and messy, and no one is likely to do it.
  247.  
  248. WinBoard (version 3.2 or later) generally runs well on the Windows 95 betas it
  249. has been tested with.  There do seem to be problems using WinBoard with
  250. 3rd-party TCP/IP implementations on the Windows 95 betas, but it works with
  251. Microsoft TCP/IP.  All versions of WinBoard run on Windows NT.
  252.  
  253. The WinBoard distribution now includes a port of GNU Chess itself to Win32.
  254. The GNU Chess port is distributed in executable form, with instructions for
  255. rebuilding it from the standard GNU Chess sources (available separately).  You
  256. should have at least 16 to 24 MB of memory to run GNU Chess with WinBoard.
  257.  
  258. cmail (topic [8]) has not been ported to Win32.
  259.  
  260. -----
  261. [8] What is cmail?
  262.  
  263. cmail is a program that helps you play and keep track of electronic mail
  264. correspondence chess games using XBoard.  It is distributed with XBoard and
  265. has its own manual page.
  266.  
  267. -----
  268. [9] What is Winsock Chess?
  269.  
  270. Winsock Chess is a program that lets two people play chess across a network.
  271. It runs only under Microsoft Windows.  Some of the code in Winsock Chess is
  272. derived from GNU Chess, but it is not maintained by the GNU Chess team.  You
  273. can get a copy from the Internet Chess Library; see topic [10].  For more
  274. information, contact its author, Donald Munro <ccahdm@beluga.upe.ac.za>.
  275.  
  276. -----
  277. [10] Where can I get chess software? 
  278.  
  279. Like other GNU software, you can get GNU Chess and XBoard by anonymous FTP
  280. from prep.ai.mit.edu and its many mirror sites.  Look in the directory pub/gnu
  281. for files matching the patterns gnuchess-*.gz and xboard-*.gz.  The .gz suffix
  282. indicates the files were compressed with GNU gzip.  You can get gzip from
  283. prep.ai.mit.edu also.
  284.  
  285. For other chess software, try the Internet Chess Library.  Use anonymous FTP
  286. to connect to ics.onenet.net, or if you have a World Wide Web browser, open
  287. URL http://caissa.onenet.net/chess/.  You can get chess software, game
  288. collections, the FAQ file for rec.games.chess, and other chess-related
  289. material there, in the directory pub/chess.  Sometimes new XBoard versions
  290. arrive on this site before they make it to prep.  The FTP server can
  291. automatically decompress files for you as you download them, useful if you
  292. don't have gzip.
  293.  
  294. You can get WinBoard from the Internet Chess Library, in directory
  295. pub/chess/Win3.
  296.  
  297. Here is a sample anonymous ftp session.  Some of the ftp server's responses
  298. are abbreviated, but all the commands you must type are included.
  299.  
  300. % ftp prep.ai.mit.edu
  301. Connected to prep.ai.mit.edu
  302. Name: anonymous
  303. Password: your-email-address@your-site
  304. ftp> binary
  305. 200 Type set to I.
  306. ftp> cd /pub/gnu
  307. 250 CWD command successful.
  308. ftp> dir gnuchess-*.gz
  309. -rw-r--r--  1 14910    wheel     1448657 Feb 21 22:17 gnuchess-4.0.pl74.tar.gz
  310. ftp> get gnuchess-4.0.pl74.tar.gz
  311. 150 Opening BINARY mode data connection for gnuchess-4.0.pl74.tar.gz (1448657 bytes).
  312. 226 Transfer complete.
  313. ftp> dir xboard-*.gz
  314. -rw-r--r--  1 14910    wheel      312553 Aug 07 20:53 xboard-3.3.pl0.tar.gz
  315. ftp> get xboard-3.3.pl0.tar.gz
  316. 150 Opening BINARY mode data connection for xboard-3.3.pl0.tar.gz (312553 bytes).
  317. 226 Transfer complete.
  318. ftp> quit
  319.  
  320. -----
  321. [11] What are the current version numbers for GNU Chess and XBoard?
  322.  
  323. At this writing, the current version numbers are:
  324.  
  325. - GNU Chess 4.0 patchlevel 74 (updated Feb 21, 1995; 1448657 bytes), plus
  326.   further patches (gnuchess-4.0.pl74.patches.tar.gz).  There is also a
  327.   patchlevel 75, but it is a beta version that was released prematurely and
  328.   has some known problems.  Patchlevel 76 is in preparation.
  329. - XBoard 3.3 patchlevel 0
  330. - WinBoard 3.3 patchlevel 0
  331. - AmyBoard 3.3 patchlevel 0
  332.  
  333. -----
  334. [12] Who is working on this project?  How do I report bugs, offer help, etc.?
  335.  
  336. Stuart Cracraft is the project coordinator.  Chua Kong Sian is the primary
  337. developer on GNU Chess.  He specializes in algorithms and search.  Tim Mann
  338. maintains the FAQ and has been the main developer on XBoard, but he is winding
  339. down his involvement and would like to find a replacement.  Many others are
  340. involved too.
  341.  
  342. You can contact all the members of the project by sending mail to
  343. bug-gnu-chess@prep.ai.mit.edu.  Comments that are of interest to all users of
  344. the software can be sent to info-gnu-chess@prep.ai.mit.edu, or posted to the
  345. gnu.chess newsgroup.  (The mailing list and newsgroup forward to each other.)
  346.  
  347. Any time you want to report a possible bug in GNU Chess or XBoard, we need to
  348. know exactly what you did, and exactly what error (or other) messages you got.
  349. Run the Unix "script" program, do whatever is necessary to reproduce the
  350. problem, type "exit" to the shell, and mail us the resulting typescript file.
  351. If you're using XBoard, run it with the -debug flag.  We also need to know
  352. what hardware/operating system combination you are using.  The command "uname
  353. -a" will often tell you this.
  354.  
  355. -----
  356. [13] Does GNU Chess run on a PC under DOS (or Windows, or OS/2)?
  357.  
  358. Note: If you have Windows NT or Windows 95, see topic [7].
  359.  
  360. Several different ports of GNU Chess to the PC are available in the Internet
  361. Chess Library (topic [10]), scattered among the directories /pub/chess/DOS,
  362. /pub/chess/DOS/OLD-STUFF, and /pub/chess/Win3.  Here is some information on
  363. them, but check the library itself for more up-to-date information.
  364.  
  365. Porting GNU software to PCs is not a major focus of the GNU project, and these
  366. ports are not supported by the FSF.  Contact the people who did the ports if
  367. you have questions or problems.
  368.  
  369. MSDOS:
  370.     gnu40-62.exe     1323260  Probably GNU Chess 4.0.pl62 for MSDOS
  371.     gnu40dos.exe T    317072  GNU Chess 4.0pl60 by Free Software Foundation
  372.                -  compiled for DOS, executables only
  373.     gnu40src.exe      307786  GNU Chess 4.0pl60 by Free Software Foundation
  374.                -  sources only
  375.     gnuchs31.exe T    270559  GNU Chess 3.1 by Free Software Foundation
  376.                -  compiled for DOS, sources and executables
  377.     gnuchs40.exe T    355494  GNU Chess 4.0pl60 by Free Software Foundation
  378.                -  compiled for 80386er, executables only
  379.  
  380. Windows:
  381.     chess321.exe W  M 238185  GNU Chess 3.21 ported by Daryl K. Baker
  382.  
  383. OS/2:
  384.     gpl65os2.zip      677824  gnuchess-4.0.pl65 compiled for os2.
  385.     gc-os2-m.zip      578032  gnuchess 4.0 for os2 with mouse support.
  386.     gnu40os2.zip     1303602  Executables for running gnuchess 4.0 pl62 under
  387.                -  OS/2. 
  388.     pmchs.exe    W  M  92004  OS/2 PM Chess 1.01 (GNU Chess 3.1 Windows by
  389.                -  Daryl K. Baker) ported to OS/2 by Kent Cedola
  390.     pmchssrc.exe      110279  OS/2 PM Chess 1.01 (GNU Chess 3.1 Windows by
  391.                -  Daryl K. Baker) sources only
  392.  
  393. -----
  394. [14] Does GNU Chess run on an Amiga?  What is AmyBoard?
  395.  
  396. There are at least three ports of GNU Chess to the Amiga: UChess,
  397. AmigaGnuChess, and gnuchess-4.0.pl74, which is using the AmyBoard port
  398. discussed below.  As with the PC ports, they are not supported by the
  399. FSF; contact the people who did the ports if you have problems or
  400. questions.
  401.  
  402. All these programs are available in the Internet Chess Library (topic
  403. [10]), in the directory /pub/chess/Amiga.  
  404.  
  405. -r--r--r--  1 chess    chess      204025 Mar 31  1993 AmigaGnuChess.lha
  406. -r--r--r--  1 chess    chess       10122 Mar 31  1993 AmigaGnuChess.readme
  407.  
  408. -r--r--r--  1 chess    chess      705327 May  7 10:28 UChess283.lha
  409. -r--r--r--  1 chess    chess       21478 May  7 10:26 UChess283.readme
  410. -r--r--r--  1 chess    chess      199387 May  7 10:27 UChess283Patch.lha
  411. -r--r--r--  1 chess    chess       21589 May  7 10:26 UChess283Patch.readme
  412.  
  413. gnuchess-4.0.pl74 doesn't have a mouse driven interface, unlike
  414. UChess and AmigaGnuChess. The interface is a separate program
  415. called AmyBoard, which is a port of XBoard (topic [4]) to the Amiga
  416. by Jochen Wiedmann. It requires MUI 2.0 or later.
  417.  
  418. If you would like to use an ICS, you need an Internet connection via either
  419. - a telnet-like program, or
  420. - a terminal program reading from stdin and writing to stdout.
  421.  
  422. AmyBoard is available in the Internet Chess Library (topic [10]).
  423.  
  424. -----
  425. [15] Does GNU Chess run on a Macintosh?
  426.  
  427. There is a port of GNU Chess 4.0 to the Macintosh.  It's available from the
  428. Internet Chess Library (topic [10]) under /pub/chess/Macintosh or
  429. /pub/chess/uploads/Macintosh, in the following files:
  430.  
  431. GnuChessMac40b5.hqx  - executable binary
  432. GCMsource40b5.hqx    - source
  433.  
  434. As with the PC ports, the Macintosh port is not supported by the Free Software
  435. Foundation.  If you have questions or problems, contact Dan Oetting
  436. <oetting@gldfs.cr.usgs.gov>.
  437.  
  438. If you have the old Mac port of GNU Chess 3.0, be sure to get 4.0 instead.
  439. GNU Chess has come a long way since version 3.0!
  440.  
  441. -----
  442. [16] How do I build GNU Chess?  Do I need gcc?
  443.  
  444. The first step to building GNU Chess is to get the distribution file and
  445. unpack it.  See topic [10] for places you can ftp the distribution from.
  446.  
  447. To unpack the gnuchess distribution, gnuchess-*.tar.gz, put it into a new,
  448. empty directory, cd there, and give this Unix command:
  449.  
  450.     gzip -cd gnuchess-*.tar.gz | tar -xvf -
  451.  
  452. If this command fails because you don't have gzip, see topic [10], and ask a
  453. local Unix expert if you need more help.
  454.  
  455. The above command will unpack all the files into a new directory.  Next, cd
  456. into this new directory.  
  457.  
  458. *** Patchlevel 74 and earlier ***
  459. You will find some instructions in a file named INSTALL.  You will also need
  460. to read and edit the Makefile in the src subdirectory before you build; it may
  461. contain information missing from the INSTALL file.
  462.  
  463. You must run all three of the following commands to fully build GNU Chess:
  464.  
  465.     make
  466.     make gnuchess.data
  467.     make install
  468.  
  469. The first make command compiles the GNU Chess programs.  (You can edit the
  470. "all:" line in the Makefile if you don't want to build all the programs.
  471. gnuchessr must always be built.  gnuchessx is required if you will be using
  472. XBoard.  The others are optional.)  The "make gnuchess.data" command builds
  473. the book.  The "make install" command copies the results to the BINDIR and
  474. LIBDIR you specified so that the different pieces can find each other.
  475. *** End patchlevel 74 and earlier ***
  476.  
  477. *** Patchlevel 75 and later ***
  478. Decide what directory tree you are going to install GNU Chess in.  The default
  479. is /usr/local.  If you have write access to this directory tree, make sure
  480. that it contains subdirectories bin, lib, and man.  (If you must "su" to get
  481. write access to /usr/local, you don't need to do so until just before the
  482. "make install" below.)  Type the following:
  483.  
  484.     configure
  485.     make
  486.     make install
  487.  
  488. If you are going to install GNU Chess under your home directory for personal
  489. use, do this instead:
  490.  
  491.     mkdir $HOME/bin $HOME/lib $HOME/man
  492.     configure --prefix=$HOME
  493.     make
  494.     make install
  495.  
  496. If you have problems or special requirements, see the files README, INSTALL,
  497. Makefile.in, and configure.in for more information.
  498. *** End patchlevel 75 and later ***
  499.  
  500. You don't need to have gcc to build GNU Chess.  However, GNU Chess is written
  501. in ANSI C.  If you have only an old K&R C compiler, be sure you have the
  502. current patchlevel of GNU Chess, and get "unproto" by:
  503.  
  504.     Wietse Venema
  505.     wietse@wzv.win.tue.nl
  506.     Mathematics and Computing Science
  507.     Eindhoven University of Technology
  508.     The Netherlands
  509.  
  510. It was released in comp.sources.misc Vol 27 with patches in vol 28 and
  511. vol 38.  Among other places, it can be found on unix.hensa.ac.uk in
  512. pub/uunet/usenet/comp.sources.misc/volume27/unproto.
  513.  
  514. Compile it and copy the cpp it produces into the gnuchess src directory before
  515. you type "make" there.
  516.  
  517. -----
  518. [17] How do I build XBoard?  Do I need gcc?
  519.  
  520. The first step to building XBoard is to get the distribution file.  See topic
  521. [10] for places you can ftp the software from.
  522.  
  523. To unpack and build the xboard distribution, xboard-*.tar.gz, give these Unix
  524. commands:
  525.  
  526.     gzip -cd xboard-*.tar.gz | tar -xvf -
  527.     cd xboard-*/
  528.     configure
  529.     make
  530.  
  531. If the first step above fails because you don't have gzip, see topic [10],
  532. and ask a local Unix expert if you need more help.  If you have any problems
  533. with the last two steps, read the READ_ME and INSTALL files in the xboard-*/
  534. directory.  You will also find this FAQ there.
  535.  
  536. You don't need to have gcc to build XBoard, and your C compiler doesn't have
  537. to be ANSI-compliant.
  538.  
  539. -----
  540. [18] When I try to use GNU Chess with XBoard, it says "Error: first chess
  541.   program (gnuchessx) exited unexpectedly".
  542.  
  543. Try running XBoard again with the "-debug" flag on the command line.  This
  544. will print out all the messages received from GNU Chess.  
  545.  
  546. If you see this problem as soon as GNU Chess starts up, most likely GNU Chess
  547. is exiting with an error message.  If you see the message "NO LANGFILE", it
  548. means that you did not install GNU Chess correctly, and it is unable to find
  549. the file gnuchess.lang.  Make sure that you defined LIBDIR in the gnuchess
  550. Makefile, and that gnuchess.lang is in that directory.  If gnuchess.lang is
  551. not there, you probably didn't type "make install" in the gnuchess src
  552. directory; you must do this to install gnuchess.lang (and the gnuchess book).
  553. If you defined LIBDIR to something that is not an absolute pathname (that is,
  554. to something that does not start with a "/"), GNU Chess will work only if you
  555. run it from the GNU Chess "src" directory where you built it.
  556.  
  557. If the problem happens while GNU Chess is running, you may have hit a GNU
  558. Chess bug.  There was a bug in 4.0 pl72 that would corrupt the stack and cause
  559. the program to exit, sometimes with a nonsensical message first, sometimes
  560. with no message.  It was especially evident on Linux.  There is some evidence
  561. that this bug is not yet fixed but just happens less often.  If you can help
  562. gather evidence to track this problem down, please let us know.  A test case
  563. that can be reproduced would be especially welcome.
  564.  
  565. -----
  566. [19] Sometimes GNU Chess plays an extra, bogus move after the game is over.
  567.  
  568. There have been bugs in some versions of GNU Chess that caused this symptom.
  569. We believe they are all fixed in 4.0 pl74 and later.
  570. -----
  571. [20] XBoard sometimes hangs when I'm using it to play against GNU Chess on a
  572.   position that I've modified with Edit Position.
  573.  
  574. You need to get the latest version of GNU Chess.  A few recent versions of GNU
  575. Chess contained a subtle change to the behavior of the "new" command that made
  576. them incompatible with previous versions and with XBoard.  There is no way to
  577. restore compatibility by changing XBoard, so instead, GNU Chess has been
  578. changed back.  See topic [11].
  579.  
  580. -----
  581. [21] GNU Chess often uses a little too much time and lets its flag fall
  582.   near the end of a time control period.
  583.  
  584. GNU Chess is known to be a bit too aggressive in using its clock time and
  585. sometimes lets its flag fall.  Some bugs that caused this symptom have been
  586. fixed, but more work on the problem may be needed.
  587.  
  588. -----
  589. [22] When I use GNU Chess with XBoard, it seems to freeze on me after
  590.   it gets out of its opening book.
  591.  
  592. First, be sure you have the latest versions of GNU Chess and XBoard; see topic
  593. [11] above.  If you do, and you still have this problem, check the following.
  594.  
  595. a) Perhaps the feature in GNU Chess that lets you stop it thinking on your
  596. time by just entering your move is not working.  This feature relies on the
  597. FIONREAD ioctl, which seems to be broken on some versions of Unix.  XBoard
  598. uses this feature if the flag -DATTENTION is not present on the DEFINES line
  599. of the XBoard Makefile.  XBoard 3.1 and later are distributed with this flag
  600. already set, so you should not have a problem unless you have removed it.
  601.  
  602. b) You might have built your GNU Chess with the wrong -D options.  With some
  603. versions of GNU Chess, this can cause GNU Chess and XBoard to disagree about
  604. what units time is measured in, causing GNU Chess to think for 100 times as
  605. long as it should.  Look at your GNU Chess Makefile and check that the line of
  606. options marked "normal", not the line marked "gnufour ICS client", is
  607. uncommented, something like this:
  608.  
  609. # gnufour ICS client
  610. #
  611. #OPT= -DUSEINT -DCACHE -DCLIENT -DGDX -DHASGETTIMEOFDAY -DNULLMOVE -DQUIETBACKGROUND -DBAREBONES -DWAY4PL64 -DHISTORY -DAGING 
  612. # normal
  613. OPT= -DUSEINT -DCACHE -DGDX -DHASGETTIMEOFDAY -DNULLMOVE -DQUIETBACKGROUND -DSEMIQUIETBOOKGEN -DWAY4PL64 -DHISTORY -DHASHSTATS -DAGING 
  614.  
  615. c) You might have a persistent transposition table (hashfile) that has been
  616. corrupted.  Look in the LIBDIR directory you defined in the GNU Chess
  617. Makefile, and if you find a file named gnuchess.hash there, remove it.  Do not
  618. use the hashfile if you are running multiple copies of GNU Chess at the same
  619. time (for instance, with Two Machines mode in XBoard).  In fact, it is
  620. probably best not to use the hashfile under any circumstances.
  621.  
  622. -----
  623. [23] When I use GNU Chess with XBoard, it sometimes tells me that moves
  624.   are illegal when they aren't.
  625.  
  626. a) First, be sure you have the latest versions of GNU Chess and XBoard; see
  627. topic [11] above.  Several different bugs that could cause this symptom
  628. existed in old versions but have been fixed in the latest ones.
  629.  
  630. b) Another possibility is that you have a persistent transposition table
  631. (hashfile) that has been corrupted.  Look in the LIBDIR directory you defined
  632. in the GNU Chess Makefile, and if you find a file named gnuchess.hash there,
  633. remove it.  Do not use the hashfile if you are running multiple copies of GNU
  634. Chess at the same time (for instance, with Two Machines mode in XBoard).  In
  635. fact, it is probably best not to use the hashfile under any circumstances.
  636.  
  637. -----
  638. [24] GNU Chess crashes when I try to compile and run it on the DEC Alpha.
  639.  
  640. Get the latest version of GNU Chess.  Some bugs that showed up only on the
  641. Alpha are fixed in version 4.0 patchlevel 73 and later.  If you still have
  642. problems, try compiling with the -migrate flag or the -O1 flag.  Some versions
  643. of the Alpha C compiler have optimizer bugs that affect GNU Chess.
  644.  
  645. -----
  646. [25] I get an error message about FIONREAD when trying to run (or build parts
  647.   of) gnuchess.
  648.  
  649. The message looks something like this:
  650.  
  651. > FIONREAD: Operation not supported on socket
  652. > You probably have a non-ANSI <ioctl.h>; see README. -1 45 4004787f
  653.  
  654. If you are using gcc to compile, the solution to this error message is usually
  655. to go to the GNU Chess Makefile, find the line that starts "CFLAGS=" (with no
  656. # character in front of it), and append the flag "-traditional-cpp" to the end
  657. of the line.  Then do
  658.  
  659.     rm dspcom*.o gnuan.o
  660.     make
  661.     make install
  662.  
  663. to rebuild gnuchess.
  664.  
  665. If you aren't using gcc, we don't really understand why this should happen,
  666. but we do have a brute-force workaround: You can simply disable the gnuchess
  667. feature that uses FIONREAD.  Find all the places in dspcom.c (and gnuan.c)
  668. where the line "#ifdef FIONREAD" occurs.  Change each of them to "#ifdef
  669. NOTDEF".  Then recompile gnuchess.
  670.  
  671. With this code disabled, if you tell gnuchess to think on your time ("hard"
  672. mode), you will have to type ^C to make it stop thinking when you want to make
  673. your move.  The current version of XBoard does this automatically, so
  674. disabling the code has no effect on XBoard.
  675.  
  676. -----
  677. [26] I can't build XBoard because xmkmf and imake are not present on my
  678.   system. 
  679.  
  680. This one is easy now.  Beginning with XBoard 3.2, xmkmf and imake are no
  681. longer required.
  682.  
  683. -----
  684. [27] I can't build XBoard because the "#include <X11/Xaw/...>" files are not
  685.   found.  (Often a problem for HP-UX users.)
  686.  
  687. These are the header files for the Athena Widgets library, which XBoard uses
  688. heavily.  Some versions of Unix don't supply these files, but they are part of
  689. the standard X distribution, freely available from MIT.  
  690.  
  691. For general information on getting missing X sources, see the FAQ on
  692. comp.windows.x.  Note that you may be missing only the header files, or you
  693. may be missing the libraries themselves too.
  694.  
  695. HP-UX users are missing only the header files.  You can get them by anonymous
  696. FTP as follows.  (But first check with your system administrator to see if
  697. someone else at your site has already done this.)  Get the archive files
  698. /hpux9/X11R5/Core/imake-5.04.tar.gz (imake and xmkmf, optional but useful) and
  699. /hpux9/X11R5/Core/Xaw-5.00.tar.gz (Xaw header files) via anonymous FTP from
  700. the site hpux.csc.liv.ac.uk (138.253.42.172), or one of the other official
  701. sites---Germany: hpux.ask.uni-karlsruhe.de (129.13.200.57), US:
  702. hpux.cae.wisc.edu (144.92.4.15), France: hpux.cict.fr (192.70.79.53) or
  703. Netherlands: hpux.ced.tudelft.nl (130.161.140.100). Unpack the archives using
  704. gzip and follow the instructions in their README and HPUX.Install files.
  705. Thanks to Richard Lloyd for this information.
  706.  
  707. If you have the Xaw header files installed in a different place than the other
  708. X11 headers, you may need to configure XBoard with an extra flag to help it
  709. find them.  For example, if yours are in /foo/bar/X11/Xaw, try this:
  710.  
  711.   rm config.cache
  712.   (setenv CFLAGS -I/foo/bar ; configure)
  713.  
  714. Also see topic [28].
  715.  
  716. -----
  717. [28] When trying to build XBoard, I get error messages about undefined symbols.
  718.  
  719. The configure script for XBoard looks for X libraries and header files in some
  720. common places.  Sometimes it fails: If yours are installed in an odd place, it
  721. may not find them at all.  If you have more than one version of X installed on
  722. your system, it may find the "wrong" one, or occasionally it may find
  723. libraries from one version and incompatible header files from another.  You
  724. can work around these problems by telling the configure script where the files
  725. are.  For example:
  726.  
  727.   configure --x-includes=/odd/place/include --x-libraries=/odd/place/lib
  728.  
  729. The directory named in the argument to --x-includes must have a subdirectory
  730. "X11" that contains the actual .h files.
  731.  
  732. Some linkers have bugs that cause bogus error messages when you try to link X
  733. programs.  The configure script includes a workaround for a bug of this kind
  734. that exists in some SunOS 4.x.x installations.  See the FAQ on comp.windows.x
  735. for more information about problems of this kind.
  736.  
  737. If you have X11R6, the configure script for XBoard 3.2.pl2 and earlier may not
  738. find all the link libraries you need.  This bug is fixed in XBoard 3.3.
  739.  
  740. If all else fails, check whether anyone else at your site has been able to
  741. compile any X programs on your system.  Your X installation might be buggy.
  742. If so, the system administrator at your site might know how to fix or work
  743. around the problem.
  744.  
  745. Also see topic [27].
  746.  
  747. -----
  748. [29] How do I use XBoard as an external viewer for PGN files with NCSA Mosaic
  749.   or Netscape?
  750.  
  751. 1) Add the following line to the file .mime.types in your home directory.
  752. (Create the file if it doesn't exist already.)
  753.  
  754. application/x-chess-pgn    pgn
  755.  
  756. 2) Add the following line to the file .mailcap in your home directory.
  757. (Create the file if it doesn't exist already.)
  758.  
  759. application/x-chess-pgn; xboard -ncp -lgf %s
  760.  
  761. 3) Exit from Mosiac and restart it.  To confirm that XBoard is working as an
  762. external viewer, open the following URL, click on "Kasparov, Gary Kimovich",
  763. and then click on any of the game names shown.
  764.  
  765. http://www.traveller.com/scripts/chess_players?Kasparov
  766.  
  767. For some reason that we don't quite understand, games under the above URL
  768. don't cause XBoard to be started when you are using Netscape; they work only
  769. with NCSA Mosaic.  Games under the following URL work with both.
  770.  
  771. http://www.ub.uit.no/chess/pgn/gamelist.html
  772.  
  773. -----
  774. [30] Does GNU Chess run on VMS?
  775.  
  776. An old VAX VMS version is available at ada.cenaath.cena.dgac.fr in the [.VMS]
  777. directory:
  778.  
  779. Directory CENA10:[ANONYMOUS.VMS]
  780.  
  781. GNUCHESS.ZIP;1                     307  21-MAR-1994 18:42:05.13
  782.  
  783. It's only a character cell version for VT100, VT200, etc. terminals.
  784.  
  785. [Thanks to Patrick Moreau for this information.]
  786.  
  787. -----
  788. [31] Does XBoard run on VMS?
  789.  
  790. No.  But please send mail to info-gnu-chess@prep.ai.mit.edu if you port
  791. XBoard to VMS.
  792.  
  793. -----
  794. [32] When I try to build GNU Chess, I get a message that "setlinebuf" is
  795. undefined.
  796.  
  797. GNU Chess is trying to use a library function that is not present in your C
  798. library (namely, setlinebuf).  There are two things to try as possible
  799. solutions:
  800.  
  801. 1) Add -DSYSV to the CFLAGS= line in the Makefile.  (To the CFLAGS line that
  802. doesn't start with a # sign, that is.)  Then do "rm nondsp.o; make".
  803.  
  804. 2) If (1) doesn't work, leaving you with a similar error, but citing setvbuf
  805. instead of setlinebuf, try the following.  Remove the -DSYSV again, go into
  806. nondsp.c, and edit the line of code where setlinebuf is called to read
  807. "setbuf(stdout, NULL);" instead.
  808.  
  809. This problem will be fixed in GNU Chess 4.0.pl76.
  810.  
  811. -----
  812. ** End of GNU Chess FAQ **
  813.